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^^^^ ISS^Ilble Markup Language (XML) server pages having custom Document Object Model (DOM) tags 

(57) A method for serving a web page uses extensible 
Markup Language (XML) server pages. The first time a 
web page Is accessed, a given flat file rs parsed into an 
XML Document Object Model (DOM) 204, 206, and 
required tag libraries are loaded. The DOM tree is then 
traversed, preferably in a depth first, inside-out nfianner to 
locate custom tags. Upon locating a custom tag a handler 
is invoked that converts the custom tag into a given 
representation vuhereby if the tag is registered as a Java 
object the object Is loaded. A process method is then 
called on the object, passing the custom tags' tree node. 
The Java object then examines the custom tag and 
replaces it with an object e,g. script code. Alternatively, if 
the tag is registered as an XSL stylesheet, the stylesheet is 
loaded and passed, together with the DOM, to an XSL 
processor. The processor applies the template to the 
custom tag and replaces it with given script code. Once all 
custom tags are reduced to HTML and script code, the 
DOM is compiled into a Java servlet 210 to service the 
client request Furthermore, the custom tag(s> and data 
identifying their associated handler(s) may be registered 
prior to processing the flat file. 
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EXTBI^SXBX^E MABKUP IiAKGUAGB (XML) SERVER PAGES 
HAVXNG CUSTOH DOC0MEl!?T OBOTECT MODEI* (DOH) TAGS 

The present invention relates generally to Internet publishing 
technologies and, in particular, to techniques for dynamically serving web 
page content. 

A Hypertext Markup Language (HTML) file uses a limited set of tags to 
convey basic information about the structure of a web docunient, e-g-, 
whether given text is a heading or a paragraph., With HTML, the style and 
logic of the document are hardcoded. HTML does not provide tags that 
define the meaning of the page element- To address this limitation, web 
content is now being authored in extensible Markup Language {XML) . which 
provides a way for an author to create a custom markup language to suit a 
particular kind of document. In XML, each document is an object, and each 
element of the document is an object. The logical structure of the 
document typically is specified in a Document Type Definition (DTD) . A DTD 
may be used by the author to define a grammar for a set of tags for the 
document so that a given application may validate the proper use of the 
tags. A DTD comprises a set of elements and their attributes, as well as a 
specification of the relationship of each element to other elements. Once 
an element is defined, it may then be associated with a stylesheet, a 
script, HT^a:J code or the like. Thus, with XML, an author may define his 
or her own tags and attributes to identify structural elements of a 
document, which may then be validated automatically. An XML document's 
internal data structure representation is a Document Object Model (DOM), 
The DOM makes it possible to address a given XML page element as a 
programmable object. It is basically a tree of all the nodes in an XML 
file. 

Page serving technologies are evolving at a rapid pace. Since 1997, 
three new major technologies have attempted to supplement, if not replace, 
dynamically generated HTML, i,e, database or CGI scripts used to generate a 
web^age on the fly. These technolo|Fie^ are Microsoft's active server page 
(ASP^'^Sun Microsystems ' s Java server^page (JSP), and the Extensible Style 
Sheet Language (XSL/XSLT) being promoted by the World Wide Web Consortium 
(W3cj^^ They provide for the generation and serving of dynamic web page 
content by enabling a page creator to write HTML and then to embed pure 
programming logic inside the page markup. Microsoft's ASP and Sun's JSP 
are very similar in that they both are essentially web templates that 
enable given code (e.g., code written in Java) to be embedded in static 



HTML to be served In response to a client browser request .^^^n an 
illustrative exan.ple, a server (and, in particular, a Java^runtitne servlet) 
responds to a client -jsp request as follows: the sexvlet retrieves a flat 
file corresponding to the requested page, translates that file into a Java 
servlet, compiles the servlet, class loads the servlet, and then invokes 
the servlet to cause given (e.g., customized) web content to be returned to 
the requesting browser. XSL/KSLT, to the contrary, is rooted in 
formatting and manipulating XML. XSLT, in particular, provides extensible 
mechanisms for defining templates to manipulate XML of any custom DTD. 

The existing techniques for serving dynamic content have various 
limitations. Conventional server- side scripting on a web page can be 
complicated and. therefore, such scripting is usually difficult to tnaintain 
and evolve. Further, with existing technologies, typically only a sxngle 
scripting language is allowed on a web page. This limitation is 
acceptable, so long as only one author is responsible for editing the page, 
or if all of the responsible authors know and use the same scripting 
language and the language of choice is supported by the web server. 
Microsoft's ASP technology supports multiple scripting languages, but only 
one language may be used on a page. Moreover, multiple langtiages cannot be 
embedded in one another, and their order of execution is undefined. 
Further, page -serving technologies such as ASP and JSP are not 
XML-compliant, and neither ASP nor JSP provides an extension mechanism to 
allow authors to add custom tags. 

It is also known in the art to provide a web page author with a 
library of preexisting custom tags. An illustrative product of this type 
is cold Fusioli^;ihich is HTML-centric. This product, however, does not 
afford the author the ability to create custom tags, Macromedia- s 
Dreamweavei^Product has a tag construction mechanism, but this product does 
not allow for the embedding of custom tags, nor does it allow the document 
to be reorganized by the tags. It also keeps the script code on the page, 
in particular, the script is hidden from the user, but it is still present 
on the page, and it may be viewed and/or edited from within another editor. 
However, the modifications made in another tool are not maintained. 
Microsoft provides a similar technology, called design-time control (DTCJ^, 
that hides code from the user but still maintains the code on the page. 
DTC is not XML-compliant and it does not allow DTCs to be embedded wxthan 
one another. Nor does the DTC mechanism allow the document to be 
reorganized . In addition, the DTC syntax is quite cumbersome for the page 
author Moreover, while other DTC-aware tools will hide the script code 



correctly, basic text-editors can still edit the code, and the changes made 
v;lll not be importable back into the DTC-aware tools. DTC also does not 
provide access to the Document Object Model. Other products or 
technologies that have custom tag extensions include HexTMX* and Meta-HWIL. 
Essentially, these are tag wacro definition languages for HTML. Such 
languages, however, are not X^3I^ compliant. 

There remains a need in the art to provide new techniques for 
publishing Internet content that can fully leverage the manipulation and 
template mechanism of XSLT with the scripting capability of the JSP/ASP 
model. The present invention addresses this need. 

According to an embodiment of the present invention, a web page 
author may define a custom DOM (Document Object Model) tag in a web page 
that, at page -translation time, is converted into script code (e,g., by a 
Java object or an XSL stylesheet). This script code is then compiled into 
Java code, and then into a Java servlet, yielding excellent performance in 
servicing a client's request for the page- Because the custom tag serves 
as a marker for a tag handler that manipulates the document, the page is 
kept clean and easy to maintain. The script code is kept separate and, 
therefore, need only be debugged once. 

Xn a preferred embodiment, custom tags are registered in an X^fIi tag 
library file.. This file preferably includes the name of the custom tag as 
well as a Java object name or a URl* naming an XSL stylesheet* The first 
time the page is accessed, the page handling engine of the present 
invention parses it into an XML Document Object Model (DOM) ^ and all the 
required tag libraries are loaded. The engine then traverses the DOM tree, 
preferably in a depth- first inside out manner, looking for registered 
custom tags. Upon finding one, if the tag is registered as a Java object, 
a bean is loaded, and a "process'* method is then called, passing the custom 
tag's tree node. The Java object has access to the entire DOM, and it may 
modify the DOM however it deems necessary. Thus, for example, the Java 
object examines the custom tag and replaces it with other custom tags, 
script code, or HTMI., Once processing is complete, the DOM is reexamined 
to identify any new tag library directives and new custom tags. If 
necessary, appropriate tag bean handlers are then invoked recursively 
according to a custom tag search algorithm. 



According to a preferred embodiment, a method for processing a 
document object model (DOM) tree including a set of custom tags begins by 



verifying a DOM data representation (e.g., a tree) against a Bocument Type 
Definition (DTD) . Thereafter, the DOM tree is examined in a given manner, 
preferably, in a depth first, inside-out manner,. For each custom tag in 
the DOM tree, the routine performs a number of substeps: retrieving a 
left-most leaf node in the tree that ie the custom tag, invoking a handler 
for the left -most leaf node, e.g>. to replace the custom tag with given 
script code, and registering, with a tag registry, any new tag libraries 
that are generated as a result of invoking the handler. After all custom 
tags in the DOM tree have processed up the tree, the tree is preferably 
collapsed into a fewest possible number of method blocks » 

An embodiment of the invention will now be described, by way of 
example, with reference to the accompanying drawings, in which: 

Figure 1 is a simplified illustration of a client-server environment 
in which the present invention may be implemented; 

Figure 2 is a high level flowchart illustrating a servlet generation 

routine 7 

Figure 3 is a flowchart illustrating how one preferred technique for 
preprocessing a flat file into XML compliant code; 

Figure 4 is a flowchart illustrating a preferred algorithm for 
processing custom tags; 

Figure 5 is a flowchart illustrating a custom DOM tag XSL handler 

routine for an XSL style sheet? 

Figure S is a flowchart illustrating a custom DOM tag Java handler 

routine for a Java object; 

Figure 7 Is a flowchart illustrating the operation of a DOM In, Text 

Out tagbean; 

Figure 8 Is a flowchart illustrating the operation of a Text In, Text 

Out Text tagbean; 

Figure 9 is a flowchart illustrating a routine for supporting 
multiple scripting languages in a single page; 

Figure 10 is a flowchart illustrating a routine for collapsing a DOM 
tree into a fewest number of method calls; and 

Figure 11 is a flowchart illustrating a routine for verifying the 
context of related XML tag elements in a DOM tree. 

The present embodiment is a page handling framework and runtime 
engine operative on a server in a computer network such as the Internet. 
AS is well-known, in the Internet paradigm as illustrated in Figure 1, a 
client machine, such as machine 10, may use an application, such as a web 
browser 12, to access a server 14 via a computer network 16. Network 16 



typically includes other seirvers (not shown) for control of domain name 
resolution, routing and other control functions. A representative server 
14 is a computer or workstation having at least one processor 18, system 
memory (e.g., RAJM) 20, disk or other permanent storage 22, I/O devices 
24a-n, an operating system 26 r a server program 28, and an application 
programming interface (APT) 30 that provides extensions to enable 
application developers to extend and/or customize the core functionality 
thereof through software programs including plug-ins, CGI programs, Java 
servlets, and the like. One such software program is an inventive page 
handling mechanism 32, which processes an HTTP page request and generates a 
response by feeding data into an output stream as will be described ^ In an 
illustrative embodiment, the page handling mechanism is implemented in Java 
and is executable in a Java Virtual Machine (JVM) by a processor in a known 
manner. Alternatively, the program may be written in whole or in part in 
native code. The inventive functionality, of course, may be part of the 
integral web server program, 

A representative server machine is an IBM Netfinity^ platform running 
the Unix^ operating system and a server program such as IBM WebSphere ^ 
Version 2.0, Of course, any other computer hardware or software may be 
used« 



A representative client is a personal computer, notebook computer ^ 
Internet appliance or pervasive computing device^ (e.g., a PDA or palm 
computer) that is Pent iumT^^ PowerPC®- or RISC-lDased. The client includes 
an ope^^ing system such as Microsoft Window^^J^icrosof t Windows CE or 
PalmOS. . A typical client includes a suite of Internet tools including a 
Web browser, such as Netscape Navigatoaj^ or Microsoft Internet Explorer, 
that has a Java Virtual Machine (JVM) and support for application plug-ins 
or helper applications. Communications between the client and the server 
typically conform to the Hypertext: Transfer Protocol (Version 1.0 or 
higher) , and such communications may be made over a secure connection „ 

The flowcharts of Figures 2-11 illustrate the inventive f imctionality 
of the page handling mechanism. 

Servlet Generation 

Figure 2 illustrates how a flat web page file is processed to 

generate a servlet. The routine begins at step 200 by retrieving a flat 
file from the server *s database. At step 202, a test is made to determine 

whether a timestamp for the flat file is later than a timestamp for the 
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further advantage of enabling the implementation of translation semantics 
using XSIi stylesheets, which is also new to the art. 



File Preparsinq 

Figure 3 illustrates a preferred technique preparsing a flat file 
into XML compliant code- This was step 204 in Figure 2, 

The routine begins at step 302 by passing the flat file to the 
preprocessor. At step 3 06, the input stream comprising the flat file is 
broken into tokens. The routine then performs a test at step 308 to 
determine whether the stream has any moxe tokens to process- If so, the 
routine continues at step 310 to test whether the token is a known JSP (or 
ASP) sytnbol. If the outcome of the test at step 310 is positive, the 
routine branches to step 312 to turn the JSP symbol into an XML tag. If 
the outcome of the test at step 310 is negative, the routine branches to 
step 314 to identify any text that violates XML, constraints. Following 
either step 312 or step 314, the routine continues at step 316 to place the 
token in an output stream holder , Control then returns to step 308 to 
process additional tokens. If the outcome of step 308 is negative, 
however, the routine branches to step 318 to verify that the ►'jsp:root" tag 
exists in the stream. At step 320, the parser turns tag libraries into 
«jsp:root^* namespace attributes « The routine then continues at step 322 by 
constructing the output stream. This completes th.e preparsing routine- 

ProcessincT a DOM with Custom Tags 

A preferred algorithm for processing a DOM with custom tags is 
illustrated in Figure 4. Preliminary processing is provided by steps 
402'*412. These steps may be omitted. In particular, the routine begins 
at step 402 by verifying the DOM, for example, with a JSP DTD. At step 
404, the routine adds servlet generation variables to the root element of 
the DOM for later handling. The routine then continues at step 406 to 
gather all j sp : directive .page tags to ensure a consistent state. At step 
40B, the jsp tag libraries (which provide support for JSP 1.0 mechanisms) 
are registered with the root element. Thus, for example, custom tags are 
registered through an XML <taglib = " tag-library. xml"> tag, according to 
the JSP 1.0 specification. 

By way of brief background, where a plurality of custom tags exist r 
it is desired to provide a cataloging and registration mechanism to 
organize the tags and to prevent naming collisions. According to the 
present embodiment, a tag library, or ^'taglib, " is used for this purpose. 
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As will be described below, the tag library is preferably specified by a 
UR,I ajid comprises a page, preferably XML, identifying the tag nameBpace 
and" listing the tags recognised in the namespace as well as the directives 
on how to load the appropriate tag handlers. Thus, in a representative 
embodiment:, in the tag-library-xml file, the name of the custom tag is 
listed, as well as a Java object name, or a nRL identifying an XSL 
stylesheet , 

The following is an example of a custom tag library: 
In the CfSP context; 
<j sp: root xmlns : Bample=i:"/xsp/ sample/sample -taglib.xml"> 

</jsp:root> 

Here, a nan^espace "sainple" is defined by the relative URL of 
« /xsp/Bample/sample- taglib , xml " 

The content at the URL would look as follows: 

<?xml version«"X-0"?> 
<taglib> 

< tag nanie:^ *' cur rentTime « 

class= " 3csp . samplB . Cur rent Tiii^eTagBean " 
dtd=^ " current Time , dtd / > 

< tag name = " cur r entTimeXS L " 

styleSheet=^"http t //localhost/xsp/sample/currentTimeCustomTag - xsl *' 
dtd«^' cur rentTime . dtd" / > 

</taglib> 

This registers a Java TagBean to handle sample : cur rentTime 
tags and registers the currentTimeCustomTag •xsl as an XSL handler for 
sample jcurentTimeXSL, As a bonus, both register cur rent Time . dtd to verify 
the correctness of the sample :currentTime and sample : cur rentTlmeXSL tags 
before the formatting of those tags occurs- 

Returning now to Figure 4, the routine then continues at step 410. 
In particular, any additional tag libraries are gathered and registered 
with a main tag handler, A tag handler is a process that is used to 
hand-off execution (of a custom tag in the DOM) to some other process, 
e.g,/ a Java object {through a custom tag interface), or via an XSL 
stylesheet. The routine then continues at step 412 by inserting a 
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jspServicemettiodDefinition as the last child of the jep^root element. The 
methodDefinition preferably has the content of most of the servlet code. 
AS will be described in more detail below, the jsp:block element is 
appended to the methodDef inition to begin the servlet -s definition as a 
S Java code block by default or with as the value of the jsp page directive 

attribute {if it is specified) . 

The main processing of the routine begins at step 4X6. At this step, 
a test is made to determine whether the DOM tree has any custom tags that 
10 have not been processed. If so, the routine branches to step 4XB to locate 

preferably the left -most leaf node of the tree that satisfies its 
requirements as a custom tag. The routine then continues at step 42 0 to 
invoke an appropriate tag handler (e.g., a Java object, the XSL stylesheet, 
or the like) .. Two variations of step 420 are illustrated in the 
15 flowcharts of Figures 5-6. As will be seen, the appropriate tag handler 

is given a current tag element and is expected to process it. Typically, a 
new DOM is returned from the tag handler and is then processed for new tag 
libraries. At step 422, the new tag libraries are registered in the tag 
library registry. The routine then continues at step 424 to gather all new 
20 jsptdirective tags. The routine then returns to step 4ie , 

This loop continues until all custom tags have been processed in a 
like manner. When the outcome of the test at step 416 is negative, the 
routine branches to step 42S to collapse the resulting DOM tree into as few 
25 as possible method blocks. This operation is illustrated in Figure 10. 

The routine then continues at step 428 to generate the servlet by 
interpreting scriptlet, expression, declaration and methodDef initions. 
Thus, for example, at step 428, the routine interprets the DOM by replacing 
-jsptscriptlets'" with inlined code, by replacing «jsp., express ions" with 
30 prints, by replacing "jsps declarations" with variables and method 

definitions, by replacing "xsp:methodcalls" with method calls, and by 
replacing "xsptmethodDef initions" with method definitions. As described in 
Figure 2, the resulting servlet is then compiled and class loaded to be 
ready for use fay the runtime code. 

35 

Cnetom Tag Definition 

Preferably, the DOM tree identifies custom tags as follows. As 
noted above, the JSP 1.0 specification included a tag library mechanism 
that defines how to plug in a tag. The specification, however, left the 
40 details of the taglib mechanism completely open, with the exception that a 

url must be used to specify the location of the taglib. According to the 
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present entoodiment , this abstract concept has been unified with an XML 
namespace and mapped into an XML file. In an illustrative embodiment, the 
Document Type Definition (DTD) for a taglib is; 
-=i ELEMENT taglib (tag)*> 
< I ELEMENT tag EMPTY> 

<!-« Note: either class or stylesheet must exist (but preferably not both) 

— > 

<!ATTLIST tag 

name CDATA #REQIJIRBD 

Class CDATA #IMPLIED 

Stylesheet CDATA ^IMPLIED 

dtd CDATA #rMPLIED> 

This data structure defines that a tag library is composed of zero or more 
tags. Each tag is defined with a name and optional attributes class, 
stylesheet, and dtd. A tag mxist have either a class or stylesheet 
attribute (but preferably not both) to specify a correct tag handler. The 
value of name is used to identify what tags it handles. If a tag-s name is 
"Bcriptlet" and its taglib prefix is "jsp", then this rule handles any tag 
named jspiscriptlef . The class and stylesheet attribute dictate which of 
the two tnechanisras are used to handle a custom tag. If the rule specifies 
a class, then a Java object, e.g., an object satisfying a custom tag 
interface, is used to process the tag. If the rule specifies a 
stylesheet, then an XSLT stylesheet is used to process the tree. The 
optional dtd parameter is used to verify the contents of the custom tag, 
for example, whether the tag has the proper attributes. 

AS noted above. Figures S-6 illustrate the preferred tag handling 
routines.. As described, there are two types of tag handling: tags handled 
by XSLT (Figure B) and tags handled by Java code (Figure 6) . Each of these 
handlers will now be described in more detail. 

XST. euBtom Tag Handler 

The XSL tag handler routine begins at step 502 by receiving the DOM 
element as input. At step 5 04, the tag handler then finds the appropriate 
stylesheet for the element as supplied by the taglib rules. The routine 
then continues at step 506 with the tag handler obtaining the element's 
parent document. At step 508, the routine invokes a stylesheet processor 
on the document and stylesheet. Finally, at step 510, the tag handler 
returns the new document to complete the translation. 
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Java Object: Custom Tag Handler 

Figure 6 illustrates a preferred operation of the custom DOM tag Java 
object handler. By way of brief background, as used herein, a "tagbean" 
is a Java object that impleraents a TagBean interface. Preferably, the 
interface is as follows: 
public interface TagBean 
{ 

public void 

process (Element element); 

} 

The TagBean interface defines a process method that takes an element in 
from the DQI^ tree and performs some function against that element » The 
context of the entire DOM tree is available to the process method for 
manipulation through the DOM APXs, 

The routine begins at step 602 with the Java tag handler receiving 
the DOM element as input. At step €04, the handler then obtains the 
appropriate tagbean for the element as supplied by the taglib rules. A 
number of tagbean routines are illustrated in Figures 7-9 and will be 
described in more detailed below. At step the handler extracts an 

attributeList from the element • The routine then performs a test at step 
608 to determine whether there are any unprocessed attributes, Xf so, the 
routine branches to step 610 to determine whether the attribute maps to a 
setter property on the tagbean. Xf the outcome of the test at step 610 is 
negative, control returns to step 608. If, however, the outcome of the 
test at step 610 is positive, the routine continues at step €12 to set the 
value of the attribute on the tagbean. Control then continues at step 614 
to remove the attribute from the attributeList, Processing then continues 
back at step 608. 

Thus, for each attribute in the attributeList, the handler checks for 
a corresponding setter property on the tagbean. If a corresponding setter 
property exists, the value of the attribute is set on the tagbean and the 
attribute is removed from the attribute list. When the outcome of the 
test at step 608 indicates that all attributes have been checked against 
the tagbean, routine branches to step 616. At this step, the tagbean 
process method is called given the DOM element so that it can manipulate 
the tree in whatever manner it deems fit. When tagbean „ process ( ) is 
complete, the new document is returned from the tag handler at step 618. 
This completes the processing « 
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Figures 7-9 illustrate tagbeans that are useful in the present 
etiibodiment , 

DOEt IiXp Text Out Tacrbean 

Figure 7 illustrates a simple DOM in, Text out macro that has the 

following class: 

piiblic abstract class SimpleTagBean implements TagBean 
{ 

public abstract String 
translateElement {Element element) ; 

public final void 
process (Element element); 

} 

SimpleTagBean is a class created to simplify the task of writing a tagbean. 
Using this class, the developer merely has to implement the 
translateElement method, which takes in a DOM element and returns the 
corresponding text macro expansion. In particular, the routine reads the 
DOM tree (e.g., using the DOM APXs) , produces an XMI, block (typically a 
scriplet) , and uses the XML block to replace the current element in the 
tree. This is advantageous to the writer of the tagbean because, he or she 
does not need to know how to create new nodes and to populate them with 
values. All the writer has to do is create an XML expanded form of the 
element passed in. While this approach requires increased execution time 
at translation, translation only happens once every time the page changes; 
thus, the technique has little impact on server performance. 

The SimpleTagBean class works as demonstrated in the flowchart of 
Figure 7- The routine begins at step 702 with the Java tag handler calls 
SimpleTagBean. process with the appropriate tag element. At step 704, the 
SimpleTagBean hands the element off to its subclass 's o vexwritt en- 
trans lateElement method. In the translateElement method, at step 706, the 
subclass looks at the element and its sub-elements and attributes to 
produce a text macro expansion of the node. The routine then continues at 
step 708 with the text expansion being returned to the 

SimpleTagBean. process method. At step 710, the XML is parsed backed into 
DOM, At Step 712, the top node of the new document object replaces the 
element that was passed in from the previous document. In particular, in 
step 712, the top node of the new DOM replaces the element was passed into 
translateElement {) . This completes the processing™ 
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Text Xn> Tejct Out: Tag-bean 

Figure 8 illustrates a Text in, Text out tagbean that may be used to 
ieoiate the deveXopex from the DOM API- This is especially useful if the 
element contains only simple Infomiation or does simple query string 
replacement* A representative class is as follows: 
ptsblic abstract class TextTagBean extends SimpleTagBean 

{ 

public abstract String 
translateText (String text); 

public final String 
translateElement (Element element) ; 

pxiblic final void 
process (Element element); 

} 

TextTagBean extends the SimpleTagBean f unctionality In particular, the 
TextTagBean extends the SimpleTagBean class and implements the 
translateElement function to inherit the String V DOM outpxit functionality. 
Instead of the developer writing translateElement, however, he or she now 
writes translateText- 

Referring now to Figure 8r the routine begins at step 802 with the 
Java custom DOM tag handler handing the SimpleTagBean. process the 
appropriate element. At step 804, the routine hands the element off to the 
"overwritten" translateElement method. At step 806, the translateElement 
method converts the DOM directly into its corresponding XML. In 
particular, the TextTagBean . translateElement { ) takes the element and 
flattens it into XMI* without interpreting any of the XML- The routine then 
continues at step 808, with the XML then being passed to the translateText 
method of the subclass. At step 810, the translateText method reads the 
string and processes it to return a new XML string. In particular, 
translateText looks at the XML string and manipulates it to produce another 
text representation of it and returns this representation to 
TextTagBean^ translateElement 0 . At step B12, the new XML string is 
returned to the TextTagBean . translateElement , which returns the string to 
SimpleTagBean- process . SimpleTagBean. process finishes the processing at 
step B14, by turning the string into DOM and, at step SIS, by replacing the 
previous element with the root of the new document. Thus, in step 816, 
the top node of the new DOM replaces the element that was passed into 
translateElement {) * This completes the processing. 
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Multiple Seriptinc r Laacmage Blocks 

another tagbean is illustrated in Figure 9. Tliis routine, called 
jsp: block, enables page developerB to use multiple scripting languages in 
the same page. As will be seen, this enables people with different skill 
sets to add value to the same page. It also enables the developer to chose 
another language that might be more suitable for a specific job. 

The routine begins at step 902 with each jsp:block handed off to the 
JSPBlockTagBean. At step 904, the JSPBlockTagBean chooses the appropriate 
BlockTagBean according to the language attribute of the jsps block element. 
At step 906. the language -specific BlockTagBean creates a methodOef inition 
element which, at step 908, is then filled with code to set up an 
appropriate runtime environment for the target language. At step 910, the 
methodDefinition element is inserted as a child of the root element in the 
document. The routine then continues at step 912 to create a methodCall 
element to replace the original jsp: block element. 

DOMt Tree Proceasing 

Figure 10 illustrates a preferred routine for collapsing the DOM tree 
into the fewest possible methodCalls, The routine begins at step 10 02 to 
test whether there are any unprocessed methodCalls in the document. If 
not, the routine is done. If, however, the outcome of the test at step 
1002 is positive, the routine continues at step 1004 by setting a variable 
mc equal to the right -most unprocessed leaf node that is a method call. At 
step 1006, the routine sets a variable collapse equal to an attribute 
mcgetAttribute (collapse) . At step 1008, the collapse attribute is 
checked. If this attribute is not true, control returns to step 1002. If 
the outcome of the test at step 1008 is positive, then the contents of the 
corresponding methodDefinition are expanded in place, and the 
methodDefinition and methodCalls are removed from the tree. In particular, 
the routine continues at step lOlO by setting a variable md equal to the 
methodDefinition for the methodCall. At step 1012, a test is run to 
determine whether any child nodes exist in the methodDefinition element. 
If not, the routine branches to step 1014 to remove mc from the document, 
and control returns to step 1002. If, however, the outcome of the test at 
step 1012 is positive, the routine continues at step 1016 to let c equal 
the last child node in the methodDefinition. At step 1018, c is removed 
from the methodDefinition. The routine then continues at step 1020 to 
insert c before mc in the document. Control then returns back to step 
1012. This ccHtipletes the processing. 
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For optimization purposes , it: is desired to verify context between 
multiple related XML tags in a DOM. One or more of these related XML tags 
are custom tags within the context of the inventive framework. By way of 
brief background, when processing a single custom tag element, that element 
may need access to all other related tags, processed and unprocessed, 
within the DOM. Unfortimately, however, there may be other unprocessed 
custom tags in the DOM thatr when processed, would result in one or more 
related tags the current element is interested in. One solution to this 
problem is to pass some state information from the current element through 
the page handling engine. A preferred technique, however, is to use the 
DOM itself to indicate state. 



Clean-'up Processing 

Figure 11 is a flowchart illustrating this clean-up processing. The 
routine begins at step 1102 during the processing of the DOM tree with a 
current element being processed replacing itself with a placeholder 
element. The placeholder element includes attributes indicating its state. 
At step X104, a test is performed to determine if a clean-up element 
already exists for the element being processed. If not, the current 
element then creates a clean-up element at step 1106.. At step 110 B, this 
clean-up element is added to the DOM in a position where it will be 
processed after all elements related to the current element have been 
processed. Thus, for example, the clean-up element is added to the DOM as 
a child node to the root position. If the outcome of the test at step 1104 
indicates that such a clean-up element already exists, the current element 
need not create another clean-up element; rather, the current element need 
only move the existing clean-up element later in the DOM to ensure it is 
processed after any other related elements might be processed. This is 
step 1110* When the processing routine finally encounters the clean-up 
element, as indicated by a positive outcome of the test at step 1112, this 
element scans the entire DOM for all the related tags (now placeholders) of 
interest. This is step 1114. At step 1116, the clean-up element loads the 
state information from each and, at step 1118, processes them accordingly. 
When complete, at step 1120, the clean-up element removes itself from the 
DOM, In this way, the technique shifts processing from each individual 
element to a single, last -processed element. 

Thus, in the preferred embodiment, a two-pass solution is 
inclement ed„ in the first pass, simple translation is performed on the 
tag, creating new tag place holders to be handled by a clean-up phase. For 
example, assume the DOM Includes the following tags; system tmacrol. 
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specific i,fo™tlo» frcn, o.he. ..9. b.t not all the xnfo^at.™ 
ILiXal.le .ntU .11 of «e„ ..ve .een touched once. 0» the 
.V3te»,».=»l e^»d. to _syet«» »crol ^ perfor»,= .11 the »etad.te 
eIp.„siou it »n perfo™ .t thi. ti™e to ...let th, ^^^^^ 
tZe, it aleo Ineerts a .y.tem.cl«»up in th. tree as the laet chxld of 
j^.root (assuming it is not already there). 



For 



The second pass is triggered when the clean-up node is hit. 
proper processing, it should checlc to maKe sure the first pass has 
completed (no syste.:.acroX or macro2 or .acro3 tags in the " 

,,ean-up nodes exist in the tree, it should remove xtself fro. the 

tree and let the other nodes handle the clean-up later. Once the clean-up 
tree and le ^^^^^^^ ^^^^^^ ^^^^ ^^^^^^^^ 

node has determined that ttie cree is. .^^ 

all the artifacts left by the first process and expands them wxth all the 

context available. 



"^^other optimization reduces the amount of code xn the tagbeans^ By 

Of baclcground. if a developer expands everything necessary to perform 
function of a tag. that process may produce large amounts of 
particular, the writing of custom taghaans may result an a large amount of 
Java code being generated into the resulting servlet. Because thxs code 
may be largely common across servlets generated from the same tagbean 
(variable names might change, but little else) , the functionalxty .s 
delegated to outside code ae much as possible. Preferably, the code xs 

VMaam arid the most convenient place to 
factored into a separate Java bean, and the ^^^^ 

delegate is the very tagbean generating the code. Thus, the tag 

"xy generate enough Java code for the servlet to call out to the separate 

bean. This dramatically reduces the code in the tag bean handler. 

AS a result, this optimisation improves maintainability and greatly 
sin^lifies debugging. In addition, because the code is not ^^^^^^^J''^ 
function is hidden from anyone who has access to the generated servlet 
code, xn addition, as a separate .ava bean, developers are encouraged to 
put more error-handling code in the system that may not get put xn 
otherwise. It also further stabilizes the system. 

Thus, in a preferred embodiment, instead of doing inline expansion of 
code, the developer may ta.e runtime values of attributes and 
and generate code to make them parameters of a method on the very same bean 
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that can be called at runtime to do the real work. Thus, at translation 
time, a custom tag in the DOM tree is replaced, e.g-, with a script that 
results in a line of code in a generated servlet, Xn that way, when the 
servlet is then executed at request time, the line of code invokes a method 
in a custom tagbean to perform a given function. 

A more detailed example of this optimization technique is set forth 
later in this disclosure. 



As has been previously described, the flowchart of Figure 2 
illustrates the basic translation functionality of the present invention. 
An example of this operation is now provided. In the following example, 
mixedlianguages-xsp is a flat input file, mixedlxanguagesDOMl , txt is a 
representation of the DOM after the input file has been parsed and some 
metadata has been added to the DOM, mixedljanguagesDOM2.txt is a 
representation of the DOM after the custom tags in the input file have been 
processed (in this case, the <block> tag is a custom tag, with the inner 
tag processed before the outer tag, with the resulting DOM then ready to be 
walked by the servlet generator routine), and tnixedlianguagesServlet .java is 
the servlet generated by walking the DOM that complies with the JSP X.O 
specification. 
mixedLanguages .xsp 
<?xml versions "1.0"?> 
<jsp:root> 

<jsp: block languages «java"> 

< j sp ; scriptlet> 

String user ^ request .get^arameter< "user" ) ; 
if (user «w nuliy { 
</ j sp : scriptlet > 

<b>Ko one is logged in.c/b> 

<; j sp : block language«r " j avascript " > 

< j sp : scriptlet> 

var int x 0 ; 

X = X + 1; 

<=/ j sp i scriptlet> 

</jap!block> 
< j sp : s c rip tie t > 

} 

else { 

</ j sp : scriptlefc> 
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<:b>WeXcorae: 
< j sp : script:let> 
out * pr intln ( user ) ; 
<:/ j sp : scriptlet> 
</b> 
<j Bp : scriptlet> 

} 

< / j sp ; Bcriptlet > 
</ j sp:block> 
</jsp;root> 



mixedLanguagesDOMl - txt 

cjsp: root eervletPatb-'^c; \top\xsp\deTno\test\TnixedLanguagesServlet , java" 
servletPackageName="xsp. test . scripting " 
servletCla3sName:=^"mixedLanguagesServlet"> 

< j sp : methodDef inition name=: "_j spService" > 
*;jsp:block languages^ » java" > 

cjsp: block language- "java"> 

< j sp : script:let:> 

String user «= request .getParameter{ "user*' ) ? 
If (user == null) { 

<b> 

No one is logged in* 

< j sp : block language^ '* j avascript « > 

< j sp : scriptlet> 

var int x = 0; 

X = X -I- I; 

< j sp : scriptlets* 

} 

else { 

<b> 

Welcome: 

< j sp : script let> 

out .println (user) ; 
< j sp ; scriptlet> 
} 

mixedIianguagesr)OM2 . txt 

< j sp : root servletPath«. « c : \ top\xsp\demo\ testXtnixedLanguageeServlet . j ava" 
servletPackagelsfaTne« "xsp . test , scripting" 
servletClassNaTne="mixedLanguagesServlet"> 

< j sp:methodDef inition narne^" javascriptBlockl" > 
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< j sp T Ecriptlet> 

BSFManager bsf Manager = new BSFManagerO ; 

BSFEnvironment bsf Environment - new BSFEnvironment () ; 

bsfEnvironment^tempDir "c;\\top\\"; 

bsf Environment v class Path ^ 
«c : WtopW ; c : \\prog\\ jdkll8\\Iib\\classes . zip ; c : \\top; c : \\prog\\xml4 j \\xml4 
j^l^l_16.jar;C:\\prog\\lotusxsl_0^17^0\\lotusxsloar;c;\\prog\\SQI.I.IB\\java 

\\cab2 j ava . zip ; c t WprogWSQLLIBW j avaWruntime . zip ; c : \\prog\\websphere\\appe 
erver\\Iib\\ibinwebas oar; c: \\prog\\webspliere\\appserver\\lib\\3sd}coar ;c: \\ 

progWwebsphereWappserverWXibW j st ., jar ; c : \\top\\bs£-l 0b6\\lib\\bsf .jar ; c 
:\\top\\bsf-1.0b6\\lib\\jsoar;C:\\top\\bsf-l,0b6\\lib\\KetRexxC„zip;C:\\pr 
og\\websphere\\appserver\\iib\\x509vl,jar; ,;Cr\\prog\\websphare\\appserver\ 
\lib\\ejsoar;c:\\;cA\prog\\websphere\\appserver\\properties\\ejs;C:\\prog 
\\jdkll6\\bin\\. A\cla5ses;C:\\prog\\jdkll6\\bin\\. A\lib\\classes.zip;Cs\\ 
progW jdkll6\\bin\\ . . \\lib\\clasaes . jar ;C: \\prog\\jdklX6\\bin\\ . . \\lib\\rt . 
jar;C:\\prog\\jdkll6\\bin\\. , WlibWilSn.jar" ; 

bsf Environment . classLoader « this , getClass { ) . getClassLoader ( ) ? 

bsfManager- setBSFEnvironment (bsfEnvirontnent) ; 

BSFEngine javascript Interpreter = 

bsf Manager , loads criptingEngine ( " j avascrlpt " ) ? 

j avascript interpreter . setDebug ( true) ; 

bsf Manager. registerBeanC "request" , request) ; 

bsf Manager . registerBean { "response^ , response) ; 

bsf Manager . registerBean (*• session" , session) ; 

bsfManager. registerBean out*' , out) ; 

bsf Manager „ registerBean ( "pageContext , pageContext ) ; 
bsfManager. registerBean ("page", this) ; 
try { 

javascriptlnterpreter.evalt"var request 
bsf . lookupBean ( \ " request\ " ) ; \nvar .response = 
bsf »lookupBean{\"response\") Anvar session ^ 

bsf .lookupBean (\«session\") ;\nvar out = bsf .lookupBean (\'*out\") ;\nvar 
pageContext = bsf . lookupBean (\»pageContext\« ) Anvar page = 
bsf. lookupBean (\*'page\'')An\n var int x - 0 An x - x + lAn 

") ; 

} catch (BSFExceptlon e) { 

Throwable realException e ,getTargetException{) ; 
while (realException instanceof BSFExceptlon) { 
realException = ( (BSFExceptlon) 
realException) . getTargetExceptlonO ; 
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while (realException instanceof 
j ava . Xang . reflect . Xnvocat ionTargatExcept ion) { 

realEscception =^ 
( ( j ava - lang . reflect , invocationTar get Exception) 
realException) .getTargetExceptioTi{ ) ; 

} 

1 

realException . prints tackTrace { ) ; 

throw new Servle tExcept ion (realException „getMessage {> ) 

) 

bsf Manager -unregisterBean ( '^request" > ; 
bsf Manager , unregisterBean ( « response « ) ? 
bsf Manager *imregi at erBe an ( " session" ) ; 
bsfManager .unregisterBean! "out" ) ; 
bsf Manager . unregisterBean ( " conf ig " ) ; 
bsf Manager .unregisterBean ( «pageContext « ) ; 
bsfManager -unregisterBean ("page" ) ; 
< j sp : methodDef inition name= " j spService " > 
< j sp ; script let > 

String user ^ request .getParameterC "user") ; 

if (user »»= null) { 

<b> 

No one is logged in. 
<j sp:methodCall name:=." javascriptBlocJcl" > 
<3Sp: Bcriptlet> 

} 

else { 

<b> 

Welcome: 
<jsp;scriptlet> 

out. println (user) ; 
< j sp : script let> 
} 

mixedLanguagesServlet . j ava 
package xsp . test . scripting ; 



ittiport org«w3c.dom** ; 

insert j ava. beans.*; 

in^rt com. lotus -xel,xml4j2tx.*; 

import javanio.*; 

import com * ibm . bsf . * ; 
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import j ava . ut i 1 . * ; 
import com . sun , server . http , * ; 
import j avax * servlet . j sp . * ; 
import com. lotus, 3CsX.*; 
import j avax, servlet.*? 
import xsp . * ? 

import com. ibm„ servlet ,pagecompile . * ; 

import com , ibm - xml , parser * * ; 

import java.net,*; 

import com . sun - server . iit i 1 . * ; 

import java-lang,*; 

import j avax . servlet . ht tp , * ; 

import com . ibm . servlet - engine . * ; 



public class mixedLanguages Servlet 
extends xsp . Contract Servlet 

{ 

piibllc void 

_jspService(HttpServletRequest req, 
HttpServlet Response res) 
throws ServletBxception, lOException 

{ 

// Cast to HttpService objects for setAttribute/callPage 
HttpServiceRequest request = (HttpServiceRequest) req; 
HttpServiceResponse response = 

new PCHttp8ervletResponseProxy( (SEHttpServiceResponse) 

JspWriter out ^ null; 

// Create the JspFactory and obtain the PageContext 
JspFactory factory - JspFactory. getDef aul tFactory (> ? 
PageContext pageContext = 

factory. get PageContext (this, // JSP page 

request, // Servlet request 
response I // Servlet response 
null^ // Error page DRIi 
true, // Servlet session 
0, // JSP buffer size 
true) ; // JSP autoflush 



try { 

// Initialize all the implicit variables 



HttpSession session = request . getiSes s ion (true) ; 
out « pageContext - getOut ( > 7 
Object page « this; 

response. setConteutType ( "text/html ; charaet=ISO"'8859-l" > j 

// Novr generate fixed template and script code 

String user = request .getParameter ( "user" ) ; 
if {user =s= null) { 

out,print{«<b>") ; 

out ,println() ; 

out *println{"No one is logged in-">; 

o\it . print In { " </b> " ) ; 

j avascriptBlockl { request , 

response, 

session, 

out, 

pageContext , 
page) ; 

} 

else { 

out.print("<:b>") ; 

out .print In () ; 

out -print In { "Welcome : " ) ; 

out . print In (user) ; 

out . println ( " c/b> " ) ; 
) 

} finally { 

out , close () ; 

( ( PCHt tpServXetResponseProxy ) response) . writeOut Response { ) 
factory, re leasePageContext (pageContext) ? 

} 

} 



public void 

j avascriptBlockl (KttpServiceRequest request , 

HttpServiceResponse response, 
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KttpSession session, 
jspWriter out, 
PageContext pageContext, 
Object page) 
throws ServIetException, lOBxception 



BSFManager bsf Manager ^ new BSFManager ( ) ; 
BSFEnvironment bsf Environment - new BSFEnvironment { ) ; 
bsf Environment. tempDir = "c:\\top\\"? 
bsfEnvironment, class Path = 
»c : WtopW ; c : WprogW j dkll8\\lib\\classes , zip? c : \\top ; c s \\prog\\3anl4 j \\xml4 
. j ar ; c : WprogW lotusxsl_0_17_0 Wlotusxsl o ar ; c t Wprog WSQbLIBX \ j ava 
Wdb2java „ zip;c: \\prog\\SOLI.IB\\java\\rtmtinie. 2ip;c : \\progWwebsphere\\apps 
erverWlibWibmwebas o ar ; c : \\prog\\websphere\\appserver\\lib\\ j sdk.j ar ; c : \\ 
prog\\webBphereWappserver\\XibWjst.jar;c:\\top\\bsf-l,0b6Wlib\\bsf . jar?c 
: WtopWbBf - 1 . ObSWlibW j s o ar ? c : WtopWbsf -1 - ObS WlibWNetRexxC . zip ; c : Wpr 
ogWwebsphere\\appserverWlibWx509vl o ar ; . ; c : WprogWwebsphere\\appserver\ 
\ libWe j s o ar ? c : W ; c : Wprog WwebsphereWappserverWpropert ies\\e j s ; c : Wprog 
W j c33cll€ WbinW , . Wclasses ; C : WprogW jdkX 16 Wbin\\ . . \\lib\\classes . zip ; C : \\ 
progWjdkll6\\binW. AMibWclasses oar ?C: WprogW jdkXlSWbinW. AXUbWrt™ 
jar;C: Wprog WjdkllsWbinW , . WlibWilSnoar" ; 

bs f Environment. classLoader = this .getclass ( ) .getClassLoader () ; 
bs f Manager »setBSFEnviranment (bsf Environment) ; 
BSFEngine javascript Interpreter = 

bsf Manager- loadScriptingSngine { "javascript" ) ; 
j avascript Interpret er , setDebug (true) ; 
bBfManager.registerBean{ "request", request) ; 
bsf Manager . registerBean { ^' response" , response) ; 
bsf Manager « registerBean ( " session" , session) ? 
bsf Manager .registerBean ( "out" , out) ; 

bsf Manager . registerBean { "pageContext " , pageContext) ; 
bsfManager. registerBean < "page" , this) ; 
try ( 

javascriptlnterpreter,eval C'var request = 
bsf .look:upBean{\"request\") ;\nvar response ^ 
bsf -lookupBean(\"response\") ;\nvar session = 

bsf .lookupBean(\"session\'*) ;\nvar out - bsf - lookupBean{\"out\*' ) ; \nvar 
pageContext ^ bsf .lookupBean {\"pageContext\" ) ;\nvar page - 

bsf .XookupBean(\"page\") ;\n\n var int x - 0;\n x x + l;\n 

") ; 

} catch (BSFException e) { 
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Throwable realException - e. getTargetExceptlon ( ) ; 
while (realException instanceof BSFException) { 
realException = ( (BSFException) 
realException} .getTargetException ( ) s 
B while (realException instanceof 

j ava , lang , reflect , Invocat lonTargetException) { 

realException = 
< { java.. lang, reflect . InvocationTargetException) 
realException) . getTargetException{) ; 
10 } 

} 

realException. prints tackTrace { ) ; 

throw new Servle tExcept ion {realException. getMessage ()) ; 

} 

15 bsf Manager .unregisterBean ( ^'request" ) ; 

bsf l^anager , xmregisterBean ( " response *' ) ; 

bsf Manager . unregisterBean ( " session" ) ; 

bsf Manager . unregisterBean ( " out " ) ; 

bsf Manager . unregisterBean ( " conf ig" ) ; 
20 bsf Manager -unregisterBean ( "pageContext " ) ; 

bsf Manager - unregisterBean ( ''page" ) ; 

} 

} 

25 The following illustrates more generally how an input file is 

translated into a DOM data structure. In particular, for a given input 
file: 

<a> 
<h> 

30 <c/> 

<d/> 
</b> 
<e> 

<f/> 

35 <g/> 
<h/> 
</e> 
</a>. 
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the DOM data structure would look as follows; 



25 



10 



15 



20 



Thus, in this example, node a is a parent node that has child nodes b 
and e. Node b has child nodes c and d, and node e has child nodes f and h. 
Node f has child node g. In the preferred embodiment, the order of node 
execution would then be as follows: c, d, b, g, f , h, e and a. The value 
of executing the nodes in an inside-out fashion is that the innermost 
tagbean can replace itself with a JSP syntax element that is well known to 
an outer tagbean so that the outer tagbean knows how to process the 
internal element. 

For example, in the case of the multi -language support, like: 



25 



30 



35 



<block language:="java"> 
<jsp:scriplet> 
j avaExpress ion ; 
javaE5qc>ression2 ; 
<:/jsp: scriptlet> 
<block language^ " j avascript " > 
< j sp : scriptlet> 

j avascriptExpr ession ; 
javascriptExpressionS ; 
< j sp : scriptlet> 
<i/block> 
c:/block> 

The block tag is a custom tag. When this tag executes, it transforms 
everything inside it into Java code. The einbodiment is able to transform 
the contained custom tag because the innermost custom tag preferably is 
handled first, and such processing leaves behind a well known tag that the 
outer most custom tag handler knows how to transform. 
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The following code illustrates how scripting language blocks may be 
used to support multiple scripting languages in a single web page. As 
described above, nesting of different scripting languages is supporting by- 
marking where one section, or "block", of code begins and where it ends» 
For example, the following snippet has JavaScript code nested within REXX 
code nested within Java code : 
if {true) { 

say I am true 

if also Tue then do 
var i = 5; 

end 

System, out ,println (bean, get Property ( ) ) ; 

} 

If this code were to appear in a web page, the blocks of code may be 
marked as follows: 
<BIjOCK language- " j ava " > 
if (true) { 

< language= " ne t rexx *' > 

say I am true 

if also True then do 

«= BLOCK language- " j avas cr ipt " > 

var i 5; 

</BLOCK> 

end 

<=/BLOCK> 

System „ out . print: In (bean , getP roper ty ( ) ) ; 

) 

</BLOCK> 

In the above example^ it can be seen that '^end'* is associated with ''if 
alsoTrue then do" and not, for example, with '^var i =5**' This enables the 
code to correctly process all the languages at runtime. In the above 
example, it should be noted that the blocks are nested. This is not a 
limitation. Indeed, there is no reason they caxmot be peers, as below: 
-cBLOCK languages^ " j ava" > 
//a little Java code here 
</BLOCK> 

<BLOCK language=?"3avaBcript"> 
/* some JavaScript code here */ 
</BLOCK>. 
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As described, the implementation compiles a web page into a XMI, 
(extensible Markup Language) DOM {Document Object Model), and from tbere, 
into a Java servlet., In tbe DOM stage, the routine looks for BLOCK nodes. 
When encountering one, the routine creates a new node representing a Java 
method definition as a child of the root element, and replaces the BLOCK 
node with a node representing a Java method call to the new method 
definition., The block's child nodes are then moved under the method 
definition. Java servlet code is then generated under the method 
definition to pass the script code contained in the block to an appropriate 
interpreter for the scripting language specified by the block's "languages- 
attribute. 

llie same operation is done for nested blocks. The innermost block is 
turned into a method definition and replaced by the method call node. When 
the next outer block is processed into its method definition, the block 
must turn any method call nodes among its children into valid method calls 
into the servlet written in the outer block's language. In the nested 
example above, the resulting Java servlet might then contain code as 

follows: 

protected void 
javaBlockO (args) 

{ 

if (true) { 

netrexxBlockO (args) ; 

System . out , println <bean , getProperty ( ) ) ; 

} 

} 

protected void 
javascriptBlockO (args) 

{ 

j avascriptlnterpreter , process ( " var i ^ 5 ; " ) ; 

1 

protected void 
netrexxBlockO (args) 

{ 

netrexxXnterpreter.processC'say I am true \n if alsoTrue then do \n 
thisServlet . j avascr iptBlockO (args ) \n end " ) ; 
) 

The bolded text above represents the method call node transformed into a 
valid method call in the particular scripting language. Because in the 
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preferred embodiment the runtime is written in Java, a special interpreter 
is not required to handle the javaBlockO script code. 

The following illustrates how context between multiple related ML 
tags ie verified. This exainple starts with a sample input XMI» chunk and 
ends with a code chunk for use in the final servlet: 
{!> xml 

< trace: sink f lle-"/myTrace,out^'> 

< trace : output >foo +- bar< / trace : output > 
< /trace : sink> 

(2) trace: output is handled by TagBean 

- creates a marker with all currently known state 

- creates a trace: cleanup- markers tag which will signal the 2nd pass 
<trace: cleanup^markers/> 

< trace : s ink f i le = " /myTr ace , out > 

<_trace_output_raarker>foo + bar<:/_trace_output_marker> 
</trace: eink> 

(3) trace: sink is handled 

- produces scriptlets to handle body of the work 

- adds metadata to _trace_output_marker 
< trace : cleanup-markers/ > 

<jsp: sci:iptlet> 
try 

FileWriter fileWriter « new PileWriter ( "/myTrace ,o\it" ) ; 
PrintWriter printWriter » new PrintWri tar (fileWriter) ; 
</ j sp : scriptlet> 

<_trace_output_marker output="printWriter" >f oo 
bar</_trace_output_marker> 
<:jsp: scriptlet> 
} finally { 

printWriter , flush ( ) ; 

fileWriter. flushO ; 

printWriter . close { ) ; 

fileWriter. close 0 ? 

} 

</ j sp ; scriptlet> 

(4) trace : cleanup-markers is handled 



- replaces _trace__oiitput_marker with a jsp: scriptlefc 
j sp : scriptlet > 

FileWriter fileWriter = new FileWriter ( "/myTrace.out") ; 

PrintWriter printWriter = new Printwriter (fileWriter) ; 
</ j sp : script let> 
< j sp : scriptlet > 

printWriter„prinfcln(foo + bar) ; 
< / j Bp : scriptlet> 
< j sp ; scr iptlet:> 
) finally { 

printWriter. f IxashO ; 

fileWriter. flush 0 ; 

printWriter * close ( ) ; 

fileWriter. close () ; 

} 

< / j sp : scriptlet> 

(5) final translation step of j sp : scriptlet to Java code 
try 

FileWriter fileWriter « new FileWriter ( "/myTrace, out") ; 
PrintWriter prlntWriter = new PrintWriter (fileWriter) ; 
printWriter.println(foo + bar); 
} finally { 

printWriter . flush ( ) ; 
f ileWriter- flush () ; 
printWriter. cloeeO ; 
fileWriter r close ( ) j 

} 

Ab also noted above, the present embodiment provides a technique 
reducing the amount of code in the tagbeans-, An example of this 
optimization technique is now provided, 

The following ServletTagBean. j is the original code file: 
package xsp^wasy 

import xsp . * ; 
import j ava „ ut il . * ; 
import org- w3c,dom, * ; 
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30 

import javaxoservlet , jsp,*; 



public class ServletTagBean extends SimpleTagBean 
5 { 

protected String name = null; 
protected String code = null; 
protected String codebase ^ null; 

10 

public void 

setl^ame ( string name) 

{ 

this. name = name; 

15 } 



public void 
setCode (String code) 
20 [ 

this. code ^ code; 

} 



25 public void 

setCodebase (string codebase) 

{ 

this „ codebase ~ codebase ; 

} 

30 

public string 

translateElement (Element element) 
{ 

3S Hashtable initParams « parse InitParams (element) , 
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// For each param siab element, add the name/value to a map for 

later 

Hashtable paratnMap = Utility-parseParams (element) ; 
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// The name ox* code parameter must be set. 
if (name null && code null) { 
// Error I i ! 

Systemsout .print: In {"Error: name and code can not be null the same 

5 time"); 

return null? 

} 

StringBuffer buff = new StringBufferO ; 
buff , append ( \n" ) 
* append (*'<") 
, append ( SCRIPTLETTAG) 
. append ( " >\n\n'' ) 
. append ( " try { \n" ) 

. append C *' String _code « null ; \n" ) ; 

if (name null) { 

buf f. append (" String jname null;\n"); 

} 

else { 

biiff .append ( " String _name ^ \"") 
.append (name) 
. append ("\";\n") ; 

} 

if {code null) { 

buff .append (" „code = \"") 
* append ( code ) 
. append ( " \ " ; \n\n" ) ; 

} 

buf f . append ( "\n if {^name ~= null || _name , ecjuals {\ " \ ^* ) ) {\n*') 
. append { ** ^natne = _code ; \n" ) 

„ append ('» }\n\n") 
35 . append (" Servlet jb = \n") 

. append ( " getServletConf ig ( ) . getServlet Context { ) , " ) 

„ append C" get Servle t C_name) ;\n'*) 
. append {'^ if (_s == null) {\n") 

. append {" Properties _init ^ new Properties {); \n" ) 

40 „ append (" _init ,put (\"naTne\" , \"") 

, append (name) 
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15 



25 
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.append ("\") An") ; 

if {code l« null) { 

buff .append (" _init .put (\«code\% \«") 

.append (code) 
.append ("\") An*^) ; 

} 

if (initParams , size C) > 0) { 

Enximeration e as initParams keys ( ) ; 
while (e ^hasMoreElements ( ) ) { 

String key « (String) e,nextElement ( } ; 

String value = (String) initParams . get (key) ; 

buff . append ( " _init ..put { \ " " ) 

.append {key} 

.append("\% \"") 

. append (value ) 

. append { " \ " ) ; \n" ) ; 

) 

} 

if {codebase 1= null) { 

buff - append ( " _ini t . put ( \ " codebase \ " , \ " " ) 

» append ( codebase } 

. append ( " \ " ) ; \n" ) 

. append { " _s = " > 

, append ( " com . sun . server , http .pagecompile An " } 
. append ( " \tServletUtil . loadServlet ( this , « ) 
, append ("NnXtXtXtNt^nameAnXtXtNtXt^code, " ) 
. append {" \n\t\t\t\t\"" ) 

. append ( codebase ) 
.append ("\", \n\t\t\t\t_init) An") ? 

} 

if (codebase null) { 

buf f. append (" - _s = "5 

* append { " com , sun. server . http pagecompile , \n\tServlettrtil . 
. append ( " loadServlet { this , ) 

. append ( "\n\t\t\t\t„name, « ) 
, append ( '* \n\t\t\t\t_code , \n\t \ t \t\tnull , " ) 
. append («\n\t\t\t\t_init) An") ; 
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} 

buf f . append ( " } \n\n" ) ? 

if (paramMap^sizeO > 0) { 

buff .append (" java .util.Hashtable Jparm = new ^" ) 
. append { " j ava . util , Hasbtable { ) ; \n " ) ; 

Enumeration e = parandviap » keys ( ) ; 
buff -append <" String 11 ^^als; \n") ; 

wliile (e .hasMoreElements ( ) ) { 

String key = (String) e . nextE lament {) ; 
String value « (String) paramMap^ get (key) r 
buff .append {" _vals « new String tl] ; \n" ) 

. append (" „vals[Ol = \'*") 

, append (value) 

.append ("\'' ?\n"} 

, append ( " Jparm . put { \ " " ) 

.append (key) 

. append ( " , _vals) ; \n" ) ; 

} 

} 

buff . append ( " \n out , flush 0 ; ) ; 

buff , append ("\n if (_s 1= null) {\n"); 

if (paramMap - isEmpty ( ) > { 

buff o append ( " com. sun . server .http - pagecotspile . " ) 

, append ( " ServletUtiX . " ) 

. append ("callServlet(_s, _name, request, response) j \n" 
) else { 

buff . append ( HttpServletRequest _r ? \n" ) 

, append {"\n _r ^ new \n com , sun . server . http ) 

, append ( «pagecompile . ParamsHttpServletRequest { » ) 

.append( "request, \n\t\t\t\t\t\t\t ^parm) ?\n«) 
, append { " com . sun . server .http . pagecompile , " ) 
.append ( "ServletUtil -callServlet (_s, " ) 
. append ("\n\t\t\t\t\t\t\t _name, ") 

. append {nn\t\t\t\t\t\t\t _r. ") 
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, append { "\n\t\t\t:\t:\t\t\t response) ; 

} 

buf f * append { " ) \n " ) 

.append{"} catch (Exception e) {\n") 
.. append ( " e . printStackTrace { ) ; \n" ) 

, append ( " throw new ServletException { \ "Exception " ) 

. append < "caught for seirvlet : +\n e*getMessage ( ) ) ; \n'*) 

..append{"}\n") 

. append ( " \n</ " ) 

, append (SCRXPTLETTAG) 

, append ( " > " ) ; 

return buff . toString ( ) ; 

) 

public Hashtable 

parselnitParams (Element element) 

{ 

Hashtable initParams = new Hashtable ( ) ; 

NamedNodeMap namedNodeMap ^ element .getAttributes () ; 
int attributeLength ^ namedNodeMap • getLength ( ) ; 

Node attributeNode i= null; 
String nodeName - mill; 
String nodeValue null; 

for (int i « Of x < attributel*ength; i++) { 
attributeNode = namedNodeMap. item(i) ; 
nodeName =s attributeNode .getKodeName { ) ; 
nodeValue = attributeNode , getNodeValue ( ) ; 
System . out . print In { "nodeNaTne=='* + nodeName -t- 
nodeValue==" + nodeValue) ; 

if ( I ( nodeName . equals ( " type " ) ) 
J ( nodeName . equal s { " Name " } } 

I {nodeName . equals ( "Code " ) ) 

I (nodeName . equals { "Codebase " ) ) ) { 

ini t Par ams , put ( nodeName , nodeValue ) ; 



35 



} 

) 

retuim initParams; 

} 

} 

The following class » ServIetTagBean, java, is the receded class using 
the delegation model, 
package xsp.was? 

import xsp , * ; 

import j ava . io . * ; 

import java.util .. *; 

import org « w3c . dom . * ; 

import j avax . searvlet * * ; 

import j avax . servlet . ht tp , * ; 

iinport javax. servlet „jsp.*; 

import com « sun . server . ht tp . pagecompiXe . * ; 

public class ServletTagBean extends simpleTagBean 
{ 

protected static int count = 0; 
public String 

translateElement (Element element) 
{ 

Properties initParametere « parse InitParams (element) ; 
Hashtafole runtimeParameters = Utility. parseParams (element) ; 

String name - (String) ini t Parameters .get { "name" ) ; 
String code - (String) initParameters -get ("code" ) ; 
String codetoase ^ (string ) in it Parameters . get { " codebase " ) i 

// The name or code parameter must be set- 
if ({name ~ null) && 
(code =ss null) ) { 

System, out, println( "Error: name and code can not be null the 

same time " ) ; 

return null; 
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} 

int GurrentCoiint = ++count; 

String initParametersNaTne 

«_xsp_servletTagBeaii_inifcParametBrs'* -f currentCount ; 

String runtimeParametersKaine = 

"_xsp_servletTagBean_ruatimeParameters" + currentCouint 

String output » 

Ilin:)ENT2 -H "<jBp:scriptlet>\n" + 

IlNrDENT2 +■ ^^Properties " + initPararaetersName + 
" new properties (); \n'' + 

INDENT2 4- *' Properties " + runtime Par ametersName ^ 
« = new Properties 0 ; \n" ; 

Enumeration enumeration = ini t Parameters -keys () ; 
while ( enumeration . hasMoreElement s ( ) ) { 

String key ^ (String) enumeration, nextEIement () ; 

String value = (String) ini t Parameters. get (key) ; 

output +=! 

INDENT2 + initParametersName + ".put(" + 
stringify(key) + " + 
stringify (value) + ; " ; 

} 

enumeration ^ runt imePar ame ter s . keys () ; 
while (enumeration. hasMoreElement s ( ) ) { 

String key = (String) enumeration. nextElement () ; 

string value = (String) runt imeParameters .get (key) ; 

output 

n:NDEKT2 + runtimeParametersName + ".putC" + 
stringify (key) " , " + 
stringify (value) + " ) ; " ; 

} 

output += 

IKDEKPr2 •¥ "xsp . was . ServletTagBean . runServlet (this , \n^ 

INDENT3 -I- "request, \n'* + 

INDENT3 + "response, \n" + 

INDEKT3 -f InitParametersName + , \n*' -f 

INDENTS -t- runtimeParametersName -t- " ) ; " ; 
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output 

INDSNT2 « c /jsp: script let > \n" , 
return output; 

) 



protected static final String 
normalize (String input) 
10 { 

if < input null) { 
return null; 

} 

input = input -trirnO ; 
15 if (input,equals("") 3 { 

return null; 

} 

return input? 

} 

20 

protected static final String 
St ringify{ String input) 

{ 

25 if (input null) { 

re turn " nul 1 " ; 

) 

return "\"" + input «\""; 

} 

30 



public static void 

runServXet {Servlet containingServlet, 
HttpServletRequest request, 
35 HttpServletResponse response. 

Properties init Parameters, 
Properties runtimeParameters) 
throws ServletException, lOException 

{ 

40 String name ^ normalize ( (String) in it Parameters .get ( "name" )) ; 

String code = normalize ( (String) initParameters .get code" )) ? 
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Stiring codebase = normalize ( (String) 
init Parameters - get { "codebase" ) ) ; 

if ({name === null) 

(code == null) ) { 

throw new IllegalStateException ( ''name or code must be 

non-null") ; 

} 

if (name null) { 
name = code; 

) 

init Parameters „ put ( "name" , name) ; 
if {code 1=^ null) { 

initParameters . put ( code« , code) ; 

} 

Servlet servXet = ServletUtil - loadServlet (containingServlet, 

name, 
code, 
codebase, 
initParameters) ; 

if { ! runtimeParameters . isEmpty { ) ) { 

request =* new PararasHttpServletRequest (request , 
runtimeParameters) ; 

} 

Servle tut il.callservlet (servlet, name, request, response) ; 

} 

pTjblic Properties 

parse XnitParams (Element element) 

{ 

Properties initParams = new Properties () ? 

NamedNodeMap namedNodeMap - element * get Attributes () ; 
int attributeLength =: namedNodeMap. get Length () ; 

Node attributeNode - null; 
String nodeName - null; 
String nodeValue ^ null; 



for (int i = 0; 1 < attributeLengfch; i-t-f) { 
attributewode = namedNodeMap*item{i) ? 
nodeName = attrifouteNode.getHodeName C) ; 
nodeValue = attributeNode *getNodeValue ( ) ; 

InitParanis ,put (normalize (nodeName) , 

ze (nodeValue) ) ; 

} 

return inltParams; 

} 

} 

The developer need not write code generation code to produce code 
that will be robust for every possible input scenario- Instead, the 
developer need only write the code once, and the only code generation is 
used to delegate to the method that is vrritten once, 

So^ to provide a generic example; 

1. String output = "out .write (\" " + string + "\")?"; 
becomes: 

2, String output ~ " Pr int TagBean, print {out , \"" string + 
"\") ;"; 

The out. write 0 is moved into a method print {) on PrintTagBean ; 
public static void 
print (Writer out. 

String string) 

{ 

out « write (string) ; 

} 

As can be seen, in the first case, the code relies upon a variable 

'out' that exists in the servlet. The write () method was called on 'out* 
passing it a string* Thus, to perform proper delegation, a method on 
PrintTagBean is created that takes 'out' and the » string* and calls 
"out .write (string) " . 

Thus, at translation time, a custom tag in the DOM tree is replaced, 
e~g., with a script that results in a line of code in a generated servlet. 
In this way, when the servlet is then executed at request time, the line of 
code invokes a method in a custom tagbean to perform a given function. 

If the code generated to handle runtime requests is longer than the 
code generated to pass the necessary variables to a method to be processed, 
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there are several benefits to this approach. First, writing code to 
generate code is a very tedious and error-prone task? thus, reducing this 
code even slightly reduces the nuinbers of errors drastically. Second, 
using this approach, all the code handling of a task is actually handled in 
a single method that can be carefully crafted to handle correct inputs to 
produce the right output. Because this code is in the tagbean^ it can be 
coTTipiled immediately and checked for language syntax errors. If, instead, 
the code is generated each time, it will not be compiled imtil an XSP is 
written to test the functionality. Moreover, with branching (if 
statements) in code generation, it may take several tests just to test the 
syntax of all the possible code generations. Further, if the developer 
needs to change the function and "optimization" has already taken place, 
then the developer need only update a single method. Otherwise, the 
developer must go through the process of updating all the code generating 
code. Because of this reduction in code and code complexity, the 
maintenance of the code will be much lower. 

The present embodiment provides numerous other advantages over the 
prior art. In effect, the page handling mechanism combines the 
manipulation and template mechanism of XSLT with the scripting capabilities 
of the JSP/ASP model. In addition, the embodiment provides a framework for 
enabling any programming language to be plugged into that model. Further, 
given that most languages are easily defined in Java byte code, the 
invention is economical to implement in a runtime using, for example, a 
Java Virtual Machine. 

The present embodiment uses custom DOM tags together with a framework 
and runtime that provides a powerful macro language to XMI^/JSP. The custom 
IX>M tags allow a web page author the ability to define a simple markup 
language tag, e.g,, <SHOPPXNG_CART>, that, at page translation time, is 
converted into script code by a generic Java object or an XSIi stylesheet. 
This script code is then compiled into Java code and then into a Java 
servlet, yielding excellent performance servicing a client's request. 
Because the custom tag replaces the script code in the authored page, the 
page is kept clean and easy to maintain. The script code is kept separate 
and, thus, need only be debugged once. Normal ASP development, on the 
contrary, would force this code to remain in the page, and it would have to 
be debugged after every modification. 

The framework is quite advantageous in that it is built on top of 
xr^. Moreover, one of ordinary skill will appreciate that the fraitiework is 
defineable programmatically or with XSL« In addition, macros written 
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according to the embodiment can affect the output of an entire page and not 
just the content between a given pair of tags. 

The embodiment also enables one or more web page authors to support 
multiple scripting languages in a single web page. Further, the context of 
multiple related XML tags in a DOM may be verified by using the DOM itself 
to indicate state information- 

As noted above, the invention mechanism is preferably implemented in 
or as an adjunct to a web server. Thus, the invention does not require any 
modifications to conventional client hardware or software. Generalising, 
the above-described functionality is implemented in software executable in 
a processor, namely, as a set of instructions (program code) in a code 
module resident in the random access memory of the computer- Until 
required by the computer, the set of instructions may be stored in another 
computer memory, for example, in a hard disk drive, or in a removable 
memory such as an optical disk {for eventual use in a CD ROM) or floppy 
disk (for eventual use in a floppy disk drive}, or downloaded via the 
Internet or other computer network. 

In addition, although the various methods described are conveniently 
implemented in a general purpose computer selectively activated or 
reconfigured by software, one of ordinary skill in the art would also 
recognize that such methods may be carried out in hardware, in fiirmware, or 
in more specialized apparatus constructed to perform the required method 
steps . 

Further, as used herein, a Web "client" should be broadly construed 
t6 mean any computer or component thereof directly or indirectly connected 
or connectable in any known or later --developed manner to a computer 
network, such as the Internet. The term Web " server « should also be 
broadly construed to mean a computer, computer platform, an adjunct to a 
computer or platform, or any component thereof. Of course, a "client" 
should be broadly construed to mean one who requests or gets the file, and 
"server" is the entity which downloads the file. 
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CLAIMS 

1, A method for serving a web page, comprising the steps of: 
processing a given file into XML compliant code; 

5 translating the XJVJL compliant code into an object model 

representation having at least one custom tag; 

processing the object model representation to generate executable 
code ; and 

invoking the executable code to generate the web page. 

10 

2. The method claimed in claim 1 wherein the step of processing the 
object model representation includes the steps of: 

parsing the object model representation to identify a custom tag; and 
upon identifying a custom tag, invoking a handler that converts the 
15 custom tag into a given representation. 

3 » The method claimed in Claim 2 wherein the given representation is 
script code . 

20 4. The method claimed in Claim 2 wherein the handler is a stylesheet 

handler. 

5, The method claimed in Claim 4 wherein the step of invoking the 
handler comprises : 

25 loading a stylesheet; axid 

passing the stylesheet and the object model representation to a 
processor. 

6. The method claimed in Claim 2 wherein the handler is a Java handler* 

30 

7. The method claimed in Claim 6 wherein the step of invoking the 
handler comprises: 

loading a Java object; 

calling a process method on the Java object; and 
35 replacing the custom tag with the given representation. 

8, The method claimed in Claim 1 further including the step of 
registering the custom tag together with data identifying a handler prior 
to processing the flat file„ 
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9, The method as described in Claim 1 wherein the executable code is a 
servlet . 

10- The method claimed in Claim 1 wherein the object model representation 
is a tree data structure, 

11, A method of serving a web page^ comprising the steps of: 
registering a set of custom tags? 

upon a given occurrence ^ processing a flat file into XML compliant 

code; 

translating the XML compliant code into a document object model 
having a subset of the set of custom tags; 

processing the document object model to generate a servlet; 
compiling the servlet into executable code? and 
invoking the executable code to generate the web page. 

12, The method claimed in Claim IX wherein the given occurrence is a 
first access of the web page,. 

13* The method claimed in Claim 11 wherein the document object model is a 
tree structure, 

14. The method claimed in Claim 13 wherein the step of processing the 
document object model includes the steps of: 

parsing the tree structure to identify each custom tag; and 
upon identifying each custom tag, invoking a handler that converts 
the custom tag into given script code. 

15. The method claimed in Claim 14 wherein the handler applies a XSL 
stylesheet to generate the given script code„ 

16 « The method claimed in Claim 14 wherein the handler executes a Java 
code object to generate the given script code. 

17* A computer program product in a computer- readable medium for managing 
the serving of a web page from a server, comprising: 

means operative upon a given occurrence for processing a flat file 
into XML compliant code; 

means for translating the XML compliant code into a document object 
model having a set of custom tags; and 
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means for processing the document object moael to generate aervlet 
code that may be compiled and invoked to generate the web page. 

18 , The computer program product claimed in Claim 17 further including 
means for registering a superset of custom tags, 

19. The computer program product claimed in Claim 17 wherein the means 

for processing comprises: 

means for parsing the tree structure to identify each custom tag? and 
means responsive to identification of a custom tag for invoking a 

handler that converts the custom tag into given script code* 

20 . The computer program product claimed in Claim 19 wherein the handler 
applies a XSIU stylesheet to generate the given script code. 

21 „ The computer program product claimed in Claim 19 wherein the handler 
executes a Java object to generate the given script code- 

22. A server, comprising: 
a processor; 
an operating system; 
a server program; 
a registry of custom tags; 

means operative upon a given occurrence for processing a flat file 
into XML compliant code? 

means for translating the XML compliant code into a document object 
model having a set of custom tags; 

means for processing the document object model to generate servlet 

code; 

means for compiling and class loading the servlet code; and 
means for invoking the searvlet code to generate the web page* 

23-. A web page, generated by: 

processing a given file into KML compliant code; 

translating the XML compliant code into an object model 
representation having at least one custom tag; 

processing the object model representation to generate executable 
code ; and 

invoking the executable code. 
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